ποΈGitΠ―ΡΠ°ποΈ
Node / meshtastic / Meshtastic-Android / files / feature / firmware / src / commonMain / kotlin / org / meshtastic / feature / firmware / ota / dfu / SecureDfuHandler.kt
Displaying Raw β’ Download
feature/firmware/src/commonMain/kotlin/org/meshtastic/feature/firmware/ota/dfu/SecureDfuHandler.kt e12c4a579d97dab1e8646fcd7bcbe710406d1076 (e12c4a57) Text, 19.40 KB
T8b949e/*
* Copyright (c) 2026 Meshtastic LLC
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
Tff7b72package T7ee787org.meshtastic.feature.firmware.ota.dfu
Tff7b72import T7ee787co.touchlab.kermit.Logger
Tff7b72import T7ee787kotlinx.coroutines.CancellationException
Tff7b72import T7ee787kotlinx.coroutines.NonCancellable
Tff7b72import T7ee787kotlinx.coroutines.delay
Tff7b72import T7ee787kotlinx.coroutines.withContext
Tff7b72import T7ee787org.koin.core.annotation.Single
Tff7b72import T7ee787org.meshtastic.core.ble.BleConnectionFactory
Tff7b72import T7ee787org.meshtastic.core.ble.BleScanner
Tff7b72import T7ee787org.meshtastic.core.common.util.CommonUri
Tff7b72import T7ee787org.meshtastic.core.common.util.ioDispatcher
Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareRelease
Tff7b72import T7ee787org.meshtastic.core.di.CoroutineDispatchers
Tff7b72import T7ee787org.meshtastic.core.model.DeviceHardware
Tff7b72import T7ee787org.meshtastic.core.repository.RadioController
Tff7b72import T7ee787org.meshtastic.core.resources.Res
Tff7b72import T7ee787org.meshtastic.core.resources.UiText
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_connecting_attempt
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_downloading_percent
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_enabling_dfu
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_not_found_in_release
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_ota_failed
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_slow_bootloader_hint
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_starting_dfu
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_uploading
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_validating
Tff7b72import T7ee787org.meshtastic.core.resources.firmware_update_waiting_reboot
Tff7b72import T7ee787org.meshtastic.core.resources.getStringSuspend
Tff7b72import T7ee787org.meshtastic.feature.firmware.FirmwareArtifact
Tff7b72import T7ee787org.meshtastic.feature.firmware.FirmwareFileHandler
Tff7b72import T7ee787org.meshtastic.feature.firmware.FirmwareRetriever
Tff7b72import T7ee787org.meshtastic.feature.firmware.FirmwareUpdateHandler
Tff7b72import T7ee787org.meshtastic.feature.firmware.FirmwareUpdateState
Tff7b72import T7ee787org.meshtastic.feature.firmware.ProgressState
Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.ThroughputTracker
Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.calculateMacPlusOne
Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.formatTransferProgress
Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.retryWithDelay
Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.scanForBleDevice
Tff7b72import T7ee787org.meshtastic.feature.firmware.stripFormatArgs
Tff7b72import T7ee787kotlin.time.Duration.Companion.seconds
Tff7b72private Tff7b72const Tff7b72val Te6edf3PERCENT_MAX Tff7b72= T79c0ff1T79c0ff0T79c0ff0
Tff7b72private Tff7b72const Tff7b72val Te6edf3GATT_RELEASE_DELAY_MS Tff7b72= T79c0ff1Te6edf3_500L
Tff7b72private Tff7b72const Tff7b72val Te6edf3DFU_REBOOT_WAIT_MS Tff7b72= T79c0ff3Te6edf3_000L
Tff7b72private Tff7b72const Tff7b72val Te6edf3RETRY_DELAY_MS Tff7b72= T79c0ff2Te6edf3_000L
Tff7b72private Tff7b72const Tff7b72val Te6edf3CONNECT_ATTEMPTS Tff7b72= T79c0ff4
T8b949e/**
* KMP [FirmwareUpdateHandler] for nRF52 devices.
*
* Despite its historical name, this handler now drives **both** Nordic Secure DFU (service `FE59`) and Nordic Legacy
* DFU / Adafruit `BLEDfu` (service `1530`). After triggering the buttonless reboot it sniffs which DFU service the
* bootloader exposes and dispatches to the matching [DfuUploadTransport] implementation.
*
* All platform I/O (zip extraction, file reading) is delegated to [FirmwareFileHandler].
*/
Tf0883e@Single
Tff7b72class T56d364SecureDfuHandlerTb4b4b4(
Tff7b72private Tff7b72val Te6edf3firmwareRetrieverTb4b4b4: Te6edf3FirmwareRetrieverTb4b4b4,
Tff7b72private Tff7b72val Te6edf3firmwareFileHandlerTb4b4b4: Te6edf3FirmwareFileHandlerTb4b4b4,
Tff7b72private Tff7b72val Te6edf3radioControllerTb4b4b4: Te6edf3RadioControllerTb4b4b4,
Tff7b72private Tff7b72val Te6edf3bleScannerTb4b4b4: Te6edf3BleScannerTb4b4b4,
Tff7b72private Tff7b72val Te6edf3bleConnectionFactoryTb4b4b4: Te6edf3BleConnectionFactoryTb4b4b4,
Tff7b72private Tff7b72val Te6edf3dispatchersTb4b4b4: Te6edf3CoroutineDispatchersTb4b4b4,
Tb4b4b4) Tb4b4b4: Te6edf3FirmwareUpdateHandler Tb4b4b4{
Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffLongMethodTa5d6ff"Tb4b4b4)
Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffstartUpdateTb4b4b4(
Te6edf3releaseTb4b4b4: Te6edf3FirmwareReleaseTb4b4b4,
Te6edf3hardwareTb4b4b4: Te6edf3DeviceHardwareTb4b4b4,
Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4,
Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,
Te6edf3firmwareUriTb4b4b4: Te6edf3CommonUri?Tb4b4b4,
Tb4b4b4)Tb4b4b4: Te6edf3FirmwareArtifact? Tb4b4b4{
Tff7b72var Te6edf3cleanupArtifactTb4b4b4: Te6edf3FirmwareArtifact? Tff7b72= Tff7b72null
Tff7b72return Tff7b72try Tb4b4b4{
Te6edf3withContextTb4b4b4(Te6edf3ioDispatcherTb4b4b4) Tb4b4b4{
T8b949e// ββ 1. Obtain the .zip file ββββββββββββββββββββββββββββββββββββββ
Te6edf3cleanupArtifact Tff7b72= Te6edf3obtainZipFileTb4b4b4(Te6edf3releaseTb4b4b4, Te6edf3hardwareTb4b4b4, Te6edf3firmwareUriTb4b4b4, Te6edf3updateStateTb4b4b4)
Tff7b72val Te6edf3zipFile Tff7b72= Te6edf3cleanupArtifact Tff7b72?: Tff7b72returnTf0883e@withContext Tff7b72null
T8b949e// ββ 2. Extract .dat and .bin from zip ββββββββββββββββββββββββββββ
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(
Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_starting_dfuTb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tff7b72val Te6edf3entries Tff7b72= Te6edf3firmwareFileHandlerTb4b4b4.Te6edf3extractZipEntriesTb4b4b4(Te6edf3zipFileTb4b4b4)
Tff7b72val Te6edf3pkg Tff7b72= Te6edf3parseDfuZipEntriesTb4b4b4(Te6edf3entriesTb4b4b4)
T8b949e// ββ 3. Disconnect mesh service, trigger buttonless DFU βββββββββββ
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(
Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_enabling_dfuTb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3radioControllerTb4b4b4.Te6edf3setDeviceAddressTb4b4b4(Ta5d6ff"Ta5d6ffnTa5d6ff"Tb4b4b4)
Te6edf3delayTb4b4b4(Te6edf3GATT_RELEASE_DELAY_MSTb4b4b4)
T8b949e// The trigger always uses SecureDfuTransport β it speaks both Secure (FE59) and Legacy (1530)
T8b949e// buttonless triggers and falls back automatically (commit f26f610c0).
Tff7b72val Te6edf3triggerTransport Tff7b72= Te6edf3SecureDfuTransportTb4b4b4(Te6edf3bleScannerTb4b4b4, Te6edf3bleConnectionFactoryTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3dispatchersTb4b4b4.Te6edf3defaultTb4b4b4)
Tff7b72try Tb4b4b4{
Te6edf3triggerTransportTb4b4b4.Te6edf3triggerButtonlessDfuTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72>
Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Buttonless trigger failed (Tffd700$Te6edf3eTa5d6ff) β device may already be in DFU modeTa5d6ff" Tb4b4b4}
Tb4b4b4}
Tb4b4b4} Tff7b72finally Tb4b4b4{
Te6edf3withContextTb4b4b4(Te6edf3NonCancellableTb4b4b4) Tb4b4b4{ Te6edf3triggerTransportTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4) Tb4b4b4}
Tb4b4b4}
Te6edf3delayTb4b4b4(Te6edf3DFU_REBOOT_WAIT_MSTb4b4b4)
T8b949e// ββ 4. Service detection: which DFU protocol does the bootloader speak? β
Tff7b72val Te6edf3protocol Tff7b72= Te6edf3detectBootloaderProtocolTb4b4b4(Te6edf3targetTb4b4b4, Te6edf3updateStateTb4b4b4)
Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Bootloader protocol detected: Tffd700$Te6edf3protocolTa5d6ff" Tb4b4b4}
T8b949e// NOTE: do NOT drop the bond for a same-address Legacy bootloader. When Meshtastic triggers
T8b949e// buttonless DFU it hands the app's bond keys to the bootloader (peer_data), and the Adafruit
T8b949e// bootloader then advertises the DFU service on the SAME address using whitelist filtering
T8b949e// (BLE_GAP_ADV_FP_FILTER_BOTH) keyed to the bonded peer. Removing the bond strips the phone's
T8b949e// identity so it no longer matches the whitelist β the phone then can't connect at all. The
T8b949e// shared LTK also lets the DFU link encrypt cleanly (verified on-air: AES-128, keySize 16), so the
T8b949e// bond must be KEPT, mirroring Nordic's DfuServiceInitiator.setKeepBond(true)/setRestoreBond(true).
T8b949e// Legacy DFU has no resume, so a failed session is retried whole (fresh transport + reconnect +
T8b949e// re-handshake), mirroring Nordic's DFU library ("the Legacy DFU will start again"). A stock
T8b949e// bootloader that leaves the first session's control-point handshake unanswered often responds
T8b949e// after a clean reconnect. Secure DFU resumes in place, so it runs a single session.
Tff7b72val Te6edf3sessionAttempts Tff7b72= Tff7b72if Tb4b4b4(Te6edf3protocol Tff7b72=Tff7b72= Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACYTb4b4b4) Te6edf3LEGACY_SESSION_ATTEMPTS Tff7b72else T79c0ff1
Te6edf3runDfuUploadWithRetryTb4b4b4(Te6edf3protocolTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3pkgTb4b4b4, Te6edf3sessionAttemptsTb4b4b4, Te6edf3updateStateTb4b4b4)
Te6edf3zipFile
Tb4b4b4}
Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3CancellationExceptionTb4b4b4) Tb4b4b4{
Tff7b72throw Te6edf3e
Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3DfuExceptionTb4b4b4) Tb4b4b4{
Te6edf3LoggerTb4b4b4.Te6edf3eTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Protocol errorTa5d6ff" Tb4b4b4}
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ErrorTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_ota_failedTb4b4b4, Te6edf3eTb4b4b4.Te6edf3message Tff7b72?: Ta5d6ff"Ta5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3cleanupArtifact
Tb4b4b4} Tff7b72catch Tb4b4b4(Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffTooGenericExceptionCaughtTa5d6ff"Tb4b4b4) Te6edf3eTb4b4b4: Te6edf3ExceptionTb4b4b4) Tb4b4b4{
Te6edf3LoggerTb4b4b4.Te6edf3eTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Unexpected errorTa5d6ff" Tb4b4b4}
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ErrorTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_ota_failedTb4b4b4, Te6edf3eTb4b4b4.Te6edf3message Tff7b72?: Ta5d6ff"Ta5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3cleanupArtifact
Tb4b4b4}
Tb4b4b4}
T8b949e// ββ Helpers ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
T8b949e/**
* Detect which DFU protocol the bootloader speaks by scanning for advertised service UUIDs. We scan for the legacy
* service (1530) first with a short timeout β Adafruit/oltaco bootloaders always advertise it, while Nordic Secure
* bootloaders never do, so a hit unambiguously means Legacy. Miss β assume Secure (preserves current behavior on
* unaffected devices).
*/
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffdetectBootloaderProtocolTb4b4b4(
Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4,
Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,
Tb4b4b4)Tb4b4b4: Te6edf3DfuProtocolKind Tb4b4b4{
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_waiting_rebootTb4b4b4)Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tff7b72val Te6edf3targetAddresses Tff7b72= Te6edf3setOfTb4b4b4(Te6edf3targetTb4b4b4, Te6edf3calculateMacPlusOneTb4b4b4(Te6edf3targetTb4b4b4)Tb4b4b4)
Tff7b72val Te6edf3legacyHit Tff7b72=
Te6edf3scanForBleDeviceTb4b4b4(
Te6edf3scanner Tff7b72= Te6edf3bleScannerTb4b4b4,
Te6edf3tag Tff7b72= Ta5d6ff"Ta5d6ffDFU detectTa5d6ff"Tb4b4b4,
Te6edf3serviceUuid Tff7b72= Te6edf3LegacyDfuUuidsTb4b4b4.Te6edf3SERVICETb4b4b4,
Te6edf3retryCount Tff7b72= T79c0ff1Tb4b4b4,
Te6edf3retryDelay Tff7b72= T79c0ff0.Te6edf3secondsTb4b4b4,
Te6edf3scanTimeout Tff7b72= Te6edf3DETECT_SCAN_TIMEOUTTb4b4b4,
Te6edf3predicate Tff7b72= Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3address Tff7b72in Te6edf3targetAddresses Tb4b4b4}Tb4b4b4,
Tb4b4b4)
Tff7b72return Tff7b72if Tb4b4b4(Te6edf3legacyHit Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACY Tff7b72else Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURE
Tb4b4b4}
T8b949e/**
* Run the connect + init + firmware upload, retrying the whole session up to [attempts] times. Each attempt uses a
* fresh [DfuUploadTransport] (new GATT connection + re-handshake) since Legacy DFU can't resume mid-stream.
*/
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffrunDfuUploadWithRetryTb4b4b4(
Te6edf3protocolTb4b4b4: Te6edf3DfuProtocolKindTb4b4b4,
Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4,
Te6edf3pkgTb4b4b4: Te6edf3DfuZipPackageTb4b4b4,
Te6edf3attemptsTb4b4b4: Tffa657IntTb4b4b4,
Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,
Tb4b4b4) Tb4b4b4{
Tff7b72var Te6edf3lastErrorTb4b4b4: Te6edf3Throwable? Tff7b72= Tff7b72null
Te6edf3repeatTb4b4b4(Te6edf3attemptsTb4b4b4) Tb4b4b4{ Te6edf3i Tff7b72-Tff7b72>
Tff7b72val Te6edf3attempt Tff7b72= Te6edf3i Tff7b72+ T79c0ff1
Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: upload session attempt Tffd700$Te6edf3attemptTa5d6ff/Tffd700$Te6edf3attemptsTa5d6ff" Tb4b4b4}
Tff7b72try Tb4b4b4{
Te6edf3runUploadSessionTb4b4b4(Te6edf3protocolTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3pkgTb4b4b4, Te6edf3updateStateTb4b4b4)
Tff7b72return
Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3CancellationExceptionTb4b4b4) Tb4b4b4{
Tff7b72throw Te6edf3e
Tb4b4b4} Tff7b72catch Tb4b4b4(Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffTooGenericExceptionCaughtTa5d6ff"Tb4b4b4) Te6edf3eTb4b4b4: Te6edf3ThrowableTb4b4b4) Tb4b4b4{
Te6edf3lastError Tff7b72= Te6edf3e
Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: upload session Tffd700$Te6edf3attemptTa5d6ff/Tffd700$Te6edf3attemptsTa5d6ff failed: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4}
T8b949e// A stock bootloader holding a wedged session from an interrupted flash rejects START with
T8b949e// INVALID_STATE, then goes unresponsive (the RESET can't land on that connection). A *fresh*
T8b949e// connection is responsive up until START, so reset it there β the device reboots into a clean OTA
T8b949e// session (GPREGRET OTA flag is retained) that the next attempt can flash normally.
Tff7b72if Tb4b4b4(Te6edf3e Tff7b72is Te6edf3LegacyDfuExceptionTb4b4b4.Te6edf3StaleSessionReset Tff7b72&Tff7b72& Te6edf3attempt Tff7b72< Te6edf3attemptsTb4b4b4) Tb4b4b4{
Te6edf3resetStaleBootloaderTb4b4b4(Te6edf3protocolTb4b4b4, Te6edf3targetTb4b4b4)
Tb4b4b4}
Tff7b72if Tb4b4b4(Te6edf3attempt Tff7b72< Te6edf3attemptsTb4b4b4) Te6edf3delayTb4b4b4(Te6edf3SESSION_RETRY_DELAY_MSTb4b4b4)
Tb4b4b4}
Tb4b4b4}
Tff7b72throw Te6edf3lastError Tff7b72?: Te6edf3DfuExceptionTb4b4b4.Te6edf3TransferFailedTb4b4b4(Ta5d6ff"Ta5d6ffDFU upload failed after Tffd700$Te6edf3attemptsTa5d6ff attemptsTa5d6ff"Tb4b4b4)
Tb4b4b4}
Tff7b72private Tff7b72fun Td2a8ffcreateTransportTb4b4b4(Te6edf3protocolTb4b4b4: Te6edf3DfuProtocolKindTb4b4b4, Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3DfuUploadTransport Tff7b72= Tff7b72when Tb4b4b4(Te6edf3protocolTb4b4b4) Tb4b4b4{
Te6edf3DfuProtocolKindTb4b4b4.Te6edf3LEGACY Tff7b72-Tff7b72> Te6edf3LegacyDfuTransportTb4b4b4(Te6edf3bleScannerTb4b4b4, Te6edf3bleConnectionFactoryTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3dispatchersTb4b4b4.Te6edf3defaultTb4b4b4)
Te6edf3DfuProtocolKindTb4b4b4.Te6edf3SECURE Tff7b72-Tff7b72> Te6edf3SecureDfuTransportTb4b4b4(Te6edf3bleScannerTb4b4b4, Te6edf3bleConnectionFactoryTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3dispatchersTb4b4b4.Te6edf3defaultTb4b4b4)
Tb4b4b4}
T8b949e/**
* Reboot a bootloader wedged in a stale DFU session. Connects a fresh transport (which is responsive before any
* START) and issues RESET (0x06) via [DfuUploadTransport.abort], then waits for the reboot + re-advertise. Best
* effort: any failure here is non-fatal β the caller retries the upload regardless.
*/
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffresetStaleBootloaderTb4b4b4(Te6edf3protocolTb4b4b4: Te6edf3DfuProtocolKindTb4b4b4, Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4) Tb4b4b4{
Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: reset-priming stale bootloader before retryTa5d6ff" Tb4b4b4}
Tff7b72val Te6edf3transport Tff7b72= Te6edf3createTransportTb4b4b4(Te6edf3protocolTb4b4b4, Te6edf3targetTb4b4b4)
Tff7b72try Tb4b4b4{
Te6edf3transport
Tb4b4b4.Te6edf3connectToDfuModeTb4b4b4(Tb4b4b4)
Tb4b4b4.Te6edf3onSuccess Tb4b4b4{
Te6edf3transportTb4b4b4.Te6edf3abortTb4b4b4(Tb4b4b4)
Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: reset-prime RESET sent; waiting for clean rebootTa5d6ff" Tb4b4b4}
Tb4b4b4}
Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Tffa657itTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: reset-prime connect failed: Tffd700${Tffa657itTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4} Tb4b4b4}
Tb4b4b4} Tff7b72finally Tb4b4b4{
Te6edf3withContextTb4b4b4(Te6edf3NonCancellableTb4b4b4) Tb4b4b4{ Te6edf3transportTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4) Tb4b4b4}
Tb4b4b4}
Te6edf3delayTb4b4b4(Te6edf3RESET_PRIME_REBOOT_WAIT_MSTb4b4b4)
Tb4b4b4}
T8b949e/** A single connect + init-packet + firmware-upload session over a fresh transport; always cleans up. */
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffrunUploadSessionTb4b4b4(
Te6edf3protocolTb4b4b4: Te6edf3DfuProtocolKindTb4b4b4,
Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4,
Te6edf3pkgTb4b4b4: Te6edf3DfuZipPackageTb4b4b4,
Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,
Tb4b4b4) Tb4b4b4{
Tff7b72val Te6edf3transportTb4b4b4: Te6edf3DfuUploadTransport Tff7b72= Te6edf3createTransportTb4b4b4(Te6edf3protocolTb4b4b4, Te6edf3targetTb4b4b4)
Tff7b72var Te6edf3completed Tff7b72= Tff7b72false
Tff7b72try Tb4b4b4{
Te6edf3connectWithRetryTb4b4b4(Te6edf3transportTb4b4b4, Te6edf3updateStateTb4b4b4)
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_starting_dfuTb4b4b4)Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{
Ta5d6ff"Ta5d6ffDFU: Sending init packet (Tffd700${Te6edf3pkgTb4b4b4.Te6edf3initPacketTb4b4b4.Te6edf3sizeTffd700}Ta5d6ff bytes) and firmware Ta5d6ff" Tff7b72+
Ta5d6ff"Ta5d6ff(Tffd700${Te6edf3pkgTb4b4b4.Te6edf3firmwareTb4b4b4.Te6edf3sizeTffd700}Ta5d6ff bytes) via Tffd700$Te6edf3protocolTa5d6ff"
Tb4b4b4}
Te6edf3transportTb4b4b4.Te6edf3transferInitPacketTb4b4b4(Te6edf3pkgTb4b4b4.Te6edf3initPacketTb4b4b4)Tb4b4b4.Te6edf3getOrThrowTb4b4b4(Tb4b4b4)
Tff7b72val Te6edf3uploadMsg Tff7b72= Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_uploadingTb4b4b4)
Tff7b72val Te6edf3slowHint Tff7b72=
Tff7b72if Tb4b4b4(Te6edf3transportTb4b4b4.Te6edf3isLowSpeedTransferTb4b4b4) Tb4b4b4{
Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_slow_bootloader_hintTb4b4b4)
Tb4b4b4} Tff7b72else Tb4b4b4{
Tff7b72null
Tb4b4b4}
Te6edf3updateStateTb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3UpdatingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3uploadMsgTb4b4b4, T79c0ff0fTb4b4b4, Te6edf3hint Tff7b72= Te6edf3slowHintTb4b4b4)Tb4b4b4)Tb4b4b4)
Tff7b72val Te6edf3firmwareSize Tff7b72= Te6edf3pkgTb4b4b4.Te6edf3firmwareTb4b4b4.Te6edf3size
Tff7b72val Te6edf3throughputTracker Tff7b72= Te6edf3ThroughputTrackerTb4b4b4(Tb4b4b4)
Te6edf3transport
Tb4b4b4.Te6edf3transferFirmwareTb4b4b4(Te6edf3pkgTb4b4b4.Te6edf3firmwareTb4b4b4) Tb4b4b4{ Te6edf3progress Tff7b72-Tff7b72>
Tff7b72val Te6edf3bytesSent Tff7b72= Tb4b4b4(Te6edf3progress Tff7b72* Te6edf3firmwareSizeTb4b4b4)Tb4b4b4.Te6edf3toLongTb4b4b4(Tb4b4b4)
Te6edf3throughputTrackerTb4b4b4.Te6edf3recordTb4b4b4(Te6edf3bytesSentTb4b4b4)
Tff7b72val Te6edf3details Tff7b72= Te6edf3formatTransferProgressTb4b4b4(Te6edf3progressTb4b4b4, Te6edf3firmwareSizeTb4b4b4, Te6edf3throughputTrackerTb4b4b4.Te6edf3bytesPerSecondTb4b4b4(Tb4b4b4)Tb4b4b4)
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3UpdatingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3uploadMsgTb4b4b4, Te6edf3progressTb4b4b4, Te6edf3detailsTb4b4b4, Te6edf3hint Tff7b72= Te6edf3slowHintTb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4}
Tb4b4b4.Te6edf3getOrThrowTb4b4b4(Tb4b4b4)
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_validatingTb4b4b4)Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3completed Tff7b72= Tff7b72true
Te6edf3updateStateTb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3SuccessTb4b4b4(Te6edf3wasLowSpeedTransfer Tff7b72= Te6edf3transportTb4b4b4.Te6edf3isLowSpeedTransferTb4b4b4)Tb4b4b4)
Tb4b4b4} Tff7b72finally Tb4b4b4{
Te6edf3withContextTb4b4b4(Te6edf3NonCancellableTb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3completedTb4b4b4) Te6edf3transportTb4b4b4.Te6edf3abortTb4b4b4(Tb4b4b4)
Te6edf3transportTb4b4b4.Te6edf3closeTb4b4b4(Tb4b4b4)
Tb4b4b4}
Tb4b4b4}
Tb4b4b4}
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffconnectWithRetryTb4b4b4(Te6edf3transportTb4b4b4: Te6edf3DfuUploadTransportTb4b4b4, Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4) Tb4b4b4{
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_waiting_rebootTb4b4b4)Tb4b4b4)Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Te6edf3retryWithDelayTb4b4b4(
Te6edf3attempts Tff7b72= Te6edf3CONNECT_ATTEMPTSTb4b4b4,
Te6edf3retryDelayMillis Tff7b72= Te6edf3RETRY_DELAY_MSTb4b4b4,
Te6edf3onAttempt Tff7b72= Tb4b4b4{ Te6edf3attempt Tff7b72-Tff7b72>
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ProcessingTb4b4b4(
Te6edf3ProgressStateTb4b4b4(
Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(
Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_connecting_attemptTb4b4b4,
Te6edf3attemptTb4b4b4,
Te6edf3CONNECT_ATTEMPTSTb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4}Tb4b4b4,
Te6edf3block Tff7b72= Tb4b4b4{ Te6edf3attempt Tff7b72-Tff7b72>
Te6edf3transportTb4b4b4.Te6edf3connectToDfuModeTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3onFailure Tb4b4b4{
Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Connect attempt Tffd700$Te6edf3attemptTa5d6ff/Tffd700$Te6edf3CONNECT_ATTEMPTSTa5d6ff failed: Tffd700${Tffa657itTb4b4b4.Te6edf3messageTffd700}Ta5d6ff" Tb4b4b4}
Tb4b4b4}
Tb4b4b4}Tb4b4b4,
Tb4b4b4)
Tb4b4b4.Te6edf3getOrElse Tb4b4b4{
Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3ConnectionFailedTb4b4b4(
Ta5d6ff"Ta5d6ffFailed to connect to DFU device after Tffd700$Te6edf3CONNECT_ATTEMPTSTa5d6ff attemptsTa5d6ff"Tb4b4b4,
Tffa657itTb4b4b4,
Tb4b4b4)
Tb4b4b4}
Tb4b4b4}
Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffobtainZipFileTb4b4b4(
Te6edf3releaseTb4b4b4: Te6edf3FirmwareReleaseTb4b4b4,
Te6edf3hardwareTb4b4b4: Te6edf3DeviceHardwareTb4b4b4,
Te6edf3firmwareUriTb4b4b4: Te6edf3CommonUri?Tb4b4b4,
Te6edf3updateStateTb4b4b4: Tb4b4b4(Te6edf3FirmwareUpdateStateTb4b4b4) Tff7b72-Tff7b72> Tffa657UnitTb4b4b4,
Tb4b4b4)Tb4b4b4: Te6edf3FirmwareArtifact? Tb4b4b4{
Tff7b72if Tb4b4b4(Te6edf3firmwareUri Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{
Tff7b72return Te6edf3FirmwareArtifactTb4b4b4(Te6edf3uri Tff7b72= Te6edf3firmwareUriTb4b4b4, Te6edf3fileName Tff7b72= Te6edf3firmwareUriTb4b4b4.Te6edf3pathSegmentsTb4b4b4.Te6edf3lastOrNullTb4b4b4(Tb4b4b4)Tb4b4b4)
Tb4b4b4}
Tff7b72val Te6edf3downloadingMsg Tff7b72= Te6edf3getStringSuspendTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_downloading_percentTb4b4b4, T79c0ff0Tb4b4b4)Tb4b4b4.Te6edf3stripFormatArgsTb4b4b4(Tb4b4b4)
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3DownloadingTb4b4b4(
Te6edf3ProgressStateTb4b4b4(Te6edf3message Tff7b72= Te6edf3UiTextTb4b4b4.Te6edf3DynamicStringTb4b4b4(Te6edf3downloadingMsgTb4b4b4)Tb4b4b4, Te6edf3progress Tff7b72= T79c0ff0fTb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tff7b72val Te6edf3path Tff7b72=
Te6edf3firmwareRetrieverTb4b4b4.Te6edf3retrieveOtaFirmwareTb4b4b4(Te6edf3releaseTb4b4b4, Te6edf3hardwareTb4b4b4) Tb4b4b4{ Te6edf3progress Tff7b72-Tff7b72>
Tff7b72val Te6edf3pct Tff7b72= Tb4b4b4(Te6edf3progress Tff7b72* Te6edf3PERCENT_MAXTb4b4b4)Tb4b4b4.Te6edf3toIntTb4b4b4(Tb4b4b4)
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3DownloadingTb4b4b4(
Te6edf3ProgressStateTb4b4b4(Te6edf3UiTextTb4b4b4.Te6edf3DynamicStringTb4b4b4(Te6edf3downloadingMsgTb4b4b4)Tb4b4b4, Te6edf3progressTb4b4b4, Ta5d6ff"Tffd700$Te6edf3pctTa5d6ff%Ta5d6ff"Tb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4}
Tff7b72if Tb4b4b4(Te6edf3path Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{
Te6edf3updateStateTb4b4b4(
Te6edf3FirmwareUpdateStateTb4b4b4.Te6edf3ErrorTb4b4b4(
Te6edf3UiTextTb4b4b4.Te6edf3ResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3firmware_update_not_found_in_releaseTb4b4b4, Te6edf3hardwareTb4b4b4.Te6edf3displayNameTb4b4b4)Tb4b4b4,
Tb4b4b4)Tb4b4b4,
Tb4b4b4)
Tb4b4b4}
Tff7b72return Te6edf3path
Tb4b4b4}
T8b949e/** Result of [detectBootloaderProtocol]. */
Tff7b72internal Tff7b72enum Tff7b72class T56d364DfuProtocolKind Tb4b4b4{
Te6edf3SECURETb4b4b4,
Te6edf3LEGACYTb4b4b4,
Tb4b4b4}
Tff7b72private Tff7b72companion Tff7b72object Tb4b4b4{
T8b949e/** Detection scan timeout β short because we only want to confirm/refute an advertised legacy service. */
Tff7b72private Tff7b72val Te6edf3DETECT_SCAN_TIMEOUT Tff7b72= T79c0ff8.Te6edf3seconds
T8b949e/** Legacy DFU can't resume, so retry the whole session this many times before giving up. */
Tff7b72private Tff7b72const Tff7b72val Te6edf3LEGACY_SESSION_ATTEMPTS Tff7b72= T79c0ff3
T8b949e/** Delay between whole-session retries (lets the bootloader settle / resume advertising). */
Tff7b72private Tff7b72const Tff7b72val Te6edf3SESSION_RETRY_DELAY_MS Tff7b72= T79c0ff2Te6edf3_000L
T8b949e/** Wait after a reset-prime RESET for the bootloader to reboot and re-advertise a clean OTA session. */
Tff7b72private Tff7b72const Tff7b72val Te6edf3RESET_PRIME_REBOOT_WAIT_MS Tff7b72= T79c0ff4Te6edf3_000L
Tb4b4b4}
Tb4b4b4}
Served by rngit 1.5.2 - Generated in 0.08s